<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>接口幂等性 - 深度解析</title>
    <link href="https://cdn.staticfile.org/font-awesome/6.4.0/css/all.min.css" rel="stylesheet">
    <link href="https://cdn.staticfile.org/tailwindcss/2.2.19/tailwind.min.css" rel="stylesheet">
    <link href="https://fonts.googleapis.com/css2?family=Noto+Serif+SC:wght@400;500;600;700&family=Noto+Sans+SC:wght@300;400;500;700&display=swap" rel="stylesheet">
    <script src="https://cdn.jsdelivr.net/npm/mermaid@latest/dist/mermaid.min.js"></script>
    <style>
        body {
            font-family: 'Noto Sans SC', Tahoma, Arial, Roboto, "Droid Sans", "Helvetica Neue", "Droid Sans Fallback", "Heiti SC", "Hiragino Sans GB", Simsun, sans-serif;
            background: linear-gradient(135deg, #f5f7fa 0%, #c3cfe2 100%);
            min-height: 100vh;
        }
        
        .hero-gradient {
            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
        }
        
        .card-hover {
            transition: all 0.3s ease;
            border: 1px solid transparent;
        }
        
        .card-hover:hover {
            transform: translateY(-5px);
            box-shadow: 0 20px 40px rgba(0,0,0,0.1);
            border-color: #667eea;
        }
        
        .text-gradient {
            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
            -webkit-background-clip: text;
            -webkit-text-fill-color: transparent;
            background-clip: text;
        }
        
        .section-title {
            position: relative;
            padding-left: 20px;
        }
        
        .section-title::before {
            content: '';
            position: absolute;
            left: 0;
            top: 50%;
            transform: translateY(-50%);
            width: 4px;
            height: 24px;
            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
            border-radius: 2px;
        }
        
        .drop-cap {
            float: left;
            font-size: 4rem;
            line-height: 1;
            font-weight: 700;
            margin-right: 8px;
            margin-top: -8px;
            color: #667eea;
            font-family: 'Noto Serif SC', serif;
        }
        
        .feature-icon {
            width: 60px;
            height: 60px;
            display: flex;
            align-items: center;
            justify-content: center;
            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
            border-radius: 16px;
            color: white;
            font-size: 24px;
            margin-bottom: 16px;
        }
        
        .mermaid {
            display: flex;
            justify-content: center;
            margin: 2rem 0;
        }
        
        .code-block {
            background: #1e1e1e;
            color: #d4d4d4;
            padding: 1.5rem;
            border-radius: 12px;
            overflow-x: auto;
            font-family: 'Consolas', 'Monaco', monospace;
            position: relative;
        }
        
        .code-block::before {
            content: 'CODE';
            position: absolute;
            top: 10px;
            right: 10px;
            font-size: 12px;
            color: #666;
            font-weight: 600;
        }
    </style>
</head>
<body>
    <!-- Hero Section -->
    <section class="hero-gradient text-white py-20">
        <div class="container mx-auto px-6">
            <div class="max-w-4xl mx-auto text-center">
                <h1 class="text-5xl md:text-6xl font-bold mb-6">
                    接口幂等性
                </h1>
                <p class="text-xl md:text-2xl opacity-90 mb-8">
                    Idempotency - 保证系统稳定性的核心原则
                </p>
                <div class="flex justify-center space-x-4">
                    <span class="bg-white bg-opacity-20 px-4 py-2 rounded-full text-sm">
                        <i class="fas fa-shield-alt mr-2"></i>安全性保障
                    </span>
                    <span class="bg-white bg-opacity-20 px-4 py-2 rounded-full text-sm">
                        <i class="fas fa-sync-alt mr-2"></i>一致性原则
                    </span>
                    <span class="bg-white bg-opacity-20 px-4 py-2 rounded-full text-sm">
                        <i class="fas fa-code mr-2"></i>最佳实践
                    </span>
                </div>
            </div>
        </div>
    </section>

    <!-- Main Content -->
    <div class="container mx-auto px-6 py-12 max-w-6xl">
        <!-- Introduction Card -->
        <div class="bg-white rounded-2xl shadow-xl p-8 mb-12 card-hover">
            <p class="text-lg leading-relaxed text-gray-700">
                <span class="drop-cap">接</span>口的幂等性（Idempotency）是指无论调用接口多少次，其效果都应该是相同的。换句话说，幂等性确保了多次执行相同的操作对系统的状态不会产生额外的副作用，保证了接口的调用结果在多次调用时一致。
            </p>
        </div>

        <!-- Definition Section -->
        <div class="mb-12">
            <h2 class="text-3xl font-bold mb-6 section-title">幂等性的定义</h2>
            <div class="bg-white rounded-2xl shadow-lg p-8 card-hover">
                <p class="text-lg leading-relaxed text-gray-700">
                    <strong class="text-purple-600">幂等性</strong>是一个数学术语，通常用于描述一个操作在多次执行时结果不变的性质。在计算机科学中，幂等性指的是某个操作可以被重复执行多次而不会改变结果。对于 Web 接口或 API 而言，这意味着调用一个接口多次产生的效果与调用一次是一样的。
                </p>
            </div>
        </div>

        <!-- Characteristics Section -->
        <div class="mb-12">
            <h2 class="text-3xl font-bold mb-6 section-title">幂等性的特点</h2>
            <div class="grid md:grid-cols-2 gap-6">
                <div class="bg-white rounded-2xl shadow-lg p-8 card-hover">
                    <div class="feature-icon">
                        <i class="fas fa-check-double"></i>
                    </div>
                    <h3 class="text-xl font-bold mb-3">一致性</h3>
                    <p class="text-gray-700">无论接口被调用多少次，最终的结果都是一致的。成功执行一次和多次的结果相同。</p>
                </div>
                <div class="bg-white rounded-2xl shadow-lg p-8 card-hover">
                    <div class="feature-icon">
                        <i class="fas fa-shield-alt"></i>
                    </div>
                    <h3 class="text-xl font-bold mb-3">安全性</h3>
                    <p class="text-gray-700">幂等操作不会对系统造成不期望的副作用，即使重复提交请求也不会引发额外的变化。</p>
                </div>
            </div>
        </div>

        <!-- HTTP Methods Visualization -->
        <div class="mb-12">
            <h2 class="text-3xl font-bold mb-6 section-title">HTTP 方法的幂等性</h2>
            <div class="bg-white rounded-2xl shadow-lg p-8">
                <div class="mermaid">
                    graph LR
                        A[HTTP 请求方法] --> B[GET<br/>幂等]
                        A --> C[PUT<br/>幂等]
                        A --> D[DELETE<br/>幂等]
                        A --> E[POST<br/>非幂等]
                        
                        B --> F[查询资源<br/>不改变状态]
                        C --> G[更新资源<br/>结果一致]
                        D --> H[删除资源<br/>效果相同]
                        E --> I[创建资源<br/>可能重复]
                        
                        style B fill:#4ade80,stroke:#22c55e,color:#fff
                        style C fill:#4ade80,stroke:#22c55e,color:#fff
                        style D fill:#4ade80,stroke:#22c55e,color:#fff
                        style E fill:#f87171,stroke:#ef4444,color:#fff
                </div>
            </div>
        </div>

        <!-- Application Section -->
        <div class="mb-12">
            <h2 class="text-3xl font-bold mb-6 section-title">幂等性的应用</h2>
            <div class="space-y-6">
                <div class="bg-white rounded-2xl shadow-lg p-8 card-hover">
                    <div class="flex items-start">
                        <span class="text-2xl text-purple-600 mr-4"><i class="fas fa-search"></i></span>
                        <div>
                            <h3 class="text-xl font-bold mb-2">GET 请求</h3>
                            <p class="text-gray-700">通常，GET 请求是幂等的，因为它们只是用于查询资源，不会对服务器状态产生影响。重复请求同一个 GET 接口，返回的数据应该是相同的。</p>
                        </div>
                    </div>
                </div>
                
                <div class="bg-white rounded-2xl shadow-lg p-8 card-hover">
                    <div class="flex items-start">
                        <span class="text-2xl text-purple-600 mr-4"><i class="fas fa-edit"></i></span>
                        <div>
                            <h3 class="text-xl font-bold mb-2">PUT 请求</h3>
                            <p class="text-gray-700">PUT 请求通常用于更新资源。在幂等的情况下，重复执行 PUT 请求应该会得到相同的结果，即使多次更新，资源的最终状态也是一致的。</p>
                        </div>
                    </div>
                </div>
                
                <div class="bg-white rounded-2xl shadow-lg p-8 card-hover">
                    <div class="flex items-start">
                        <span class="text-2xl text-purple-600 mr-4"><i class="fas fa-trash"></i></span>
                        <div>
                            <h3 class="text-xl font-bold mb-2">DELETE 请求</h3>
                            <p class="text-gray-700">DELETE 请求通常也是幂等的。无论删除操作被执行多少次，资源要么被删除，要么已经不存在。重复执行 DELETE 请求的效果与执行一次相同。</p>
                        </div>
                    </div>
                </div>
                
                <div class="bg-white rounded-2xl shadow-lg p-8 card-hover">
                    <div class="flex items-start">
                        <span class="text-2xl text-purple-600 mr-4"><i class="fas fa-plus"></i></span>
                        <div>
                            <h3 class="text-xl font-bold mb-2">POST 请求</h3>
                            <p class="text-gray-700">POST 请求通常用于创建资源，通常不是幂等的。重复执行 POST 请求可能会创建多个相同的资源。因此，为了实现幂等性，通常需要在接口中加入一些机制，例如使用唯一标识符来避免重复创建。</p>
                        </div>
                    </div>
                </div>
            </div>
        </div>

        <!-- Implementation Strategies -->
        <div class="mb-12">
            <h2 class="text-3xl font-bold mb-6 section-title">实现幂等性的策略</h2>
            <div class="bg-white rounded-2xl shadow-lg p-8">
                <div class="mermaid">
                    graph TD
                        A[实现幂等性] --> B[唯一请求标识符]
                        A --> C[检查资源状态]
                        A --> D[幂等操作设计]
                        A --> E[数据库约束]
                        A --> F[幂等性日志]
                        
                        B --> G[客户端生成UUID]
                        C --> H[预检查机制]
                        D --> I[操作原子化]
                        E --> J[唯一索引约束]
                        F --> K[操作历史记录]
                        
                        style A fill:#667eea,stroke:#764ba2,color:#fff
                </div>
                
                <div class="grid md:grid-cols-2 gap-6 mt-8">
                    <div class="bg-gray-50 rounded-xl p-6">
                        <h4 class="font-bold text-lg mb-3 text-purple-600">
                            <i class="fas fa-fingerprint mr-2"></i>使用唯一请求标识符
                        </h4>
                        <p class="text-gray-700">对于需要幂等的 POST 请求，可以使用唯一的请求标识符来识别每个请求。例如，通过客户端生成唯一的 ID，并在服务器端记录已处理的请求 ID，避免重复处理。</p>
                    </div>
                    
                    <div class="bg-gray-50 rounded-xl p-6">
                        <h4 class="font-bold text-lg mb-3 text-purple-600">
                            <i class="fas fa-check-circle mr-2"></i>检查资源状态
                        </h4>
                        <p class="text-gray-700">在执行操作之前，可以先检查资源